AM
ID
Mulai Gratis
Menu

Contents

User resource management

DELETE/api/users/{user_id}

Delete a user and their credentials, preventing future access. The account is preserved even if this is the last user, maintaining historical data like payment history. More Authentication

Responses
200application/json
OK
schemaobject
dataUserrequired
A user within an application who can authenticate and access resources. Users belong to an Application and access Accounts via memberships.
idstringrequired
Unique identifier for a user.
application_idstringrequired
Unique identifier for an application.
statusrequired
linksobjectrequired
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/users/{user_id}

Retrieve a user by their ID. Returns the user’s profile, email credentials, and account memberships. Access is scoped by the caller’s permissions. More Authentication

Responses
200application/json
OK
schemaobject
dataProfilerequired
A user's complete profile including their email credentials, account memberships, and identity information.
idstringrequired
Unique identifier for a user.
application_idstringrequired
Unique identifier for an application.
statusrequired
credentialsarrayrequired
itemEmailCredentialrequired
Nested fields truncated. Expand to continue inline, or use the model link.
Associates an email address with a user for authentication. Used to look up users during login flows and verify email ownership.
membershipsarrayrequired
itemallOfrequired
Variant
Links a user to an account with a specific role (owner, member, or viewer). Users can have memberships in multiple accounts.
MembershipMembership
Nested fields truncated. Expand to continue inline, or use the model link.
Links a user to an account with a specific role (owner, member, or viewer). Users can have memberships in multiple accounts.
Option 2object
Nested fields truncated. Expand to continue inline, or use the model link.
identityUserIdentity | nullUserIdentityrequired
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
idstringrequired
Unique identifier for a user.
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
PATCH/api/users/{user_id}

Update user properties using JSON Merge Patch (RFC 7396). Modify user status, profile fields, and account associations. More Authentication

Body application/json
status
Responses
200application/json
OK
schemaobject
dataUserrequired
A user within an application who can authenticate and access resources. Users belong to an Application and access Accounts via memberships.
idstringrequired
Unique identifier for a user.
application_idstringrequired
Unique identifier for an application.
statusrequired
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/users/{user_id}/files

List file metadata for a user by prefix.

Responses
200application/json
OK
schemaobject
dataarrayrequired
itemS3FileMetadatarequired
Metadata for a file stored in object storage.
keystringrequired
pathstringrequired
size_bytesnumberrequired
etagstring | nullrequired
last_modifiedstring · date-timerequired
storage_classstring | nullrequired
linksobjectrequired
selfstringrequired
URL of the current page
nextstring
URL of the next page
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/users/{user_id}/files/multipart/abort

Generate presigned URLs for file writes and coordinate multipart uploads.

Body application/json
pathstringrequired
upload_idstringrequired
Responses
200application/json
OK
schemaobject
Multipart upload abort response.
upload_idstringrequired
keystringrequired
linksobjectrequired
selfstringrequired
URL of the created resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/users/{user_id}/files/multipart/complete

Generate presigned URLs for file writes and coordinate multipart uploads.

Body application/json
pathstringrequired
upload_idstringrequired
partsarrayrequired
itemobjectrequired
part_numberintegerrequired
etagstringrequired
Responses
200application/json
OK
schemaobject
Multipart upload completion response.
upload_idstringrequired
keystringrequired
etagstring
locationstring
linksobjectrequired
selfstringrequired
URL of the created resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/users/{user_id}/files/multipart/init

Generate presigned URLs for file writes and coordinate multipart uploads.

Body application/json
pathstringrequired
content_typestring
Responses
200application/json
OK
schemaobject
Multipart upload initialization response.
upload_idstringrequired
keystringrequired
linksobjectrequired
selfstringrequired
URL of the created resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/users/{user_id}/files/multipart/part

Generate presigned URLs for file writes and coordinate multipart uploads.

Body application/json
pathstringrequired
upload_idstringrequired
part_numberintegerrequired
content_lengthintegerrequired
content_typestring
Responses
200application/json
OK
schemaobject
Presigned URL response for direct storage access.
urlstring · urirequired
headersobject
expires_atstring · date-timerequired
linksobjectrequired
selfstringrequired
URL of the created resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/users/{user_id}/files/presign

Generate presigned URLs for file writes and coordinate multipart uploads.

Body application/json
pathstringrequired
content_typestringrequired
content_lengthintegerrequired
Responses
200application/json
OK
schemaobject
Presigned URL response for direct storage access.
urlstring · urirequired
headersobject
expires_atstring · date-timerequired
linksobjectrequired
selfstringrequired
URL of the created resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/users/{user_id}/files/presign/delete

Generate presigned URLs for file writes and coordinate multipart uploads.

Body application/json
pathstringrequired
Responses
200application/json
OK
schemaobject
Presigned URL response for direct storage access.
urlstring · urirequired
headersobject
expires_atstring · date-timerequired
linksobjectrequired
selfstringrequired
URL of the created resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
DELETE/api/users/{user_id}/identity

Delete a user’s identity to remove all PII while preserving the user reference. Use for data regulation compliance like GDPR right-to-be-forgotten. More Privacy

Responses
200application/json
OK
schemaobject
dataallOfrequired
Variant
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
UserIdentityUserIdentity
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
idstringrequired
Unique identifier for a user.
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
Option 2object
userUserrequired
Nested fields truncated. Expand to continue inline, or use the model link.
A user within an application who can authenticate and access resources. Users belong to an Application and access Accounts via memberships.
linksobjectrequired
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/users/{user_id}/identity

Retrieve a user’s identity containing PII like name and locale. Identity data can be deleted separately from the user to comply with data regulations. More Privacy

Responses
200application/json
OK
schemaobject
dataallOfrequired
Variant
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
UserIdentityUserIdentity
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
idstringrequired
Unique identifier for a user.
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
Option 2object
userUserrequired
Nested fields truncated. Expand to continue inline, or use the model link.
A user within an application who can authenticate and access resources. Users belong to an Application and access Accounts via memberships.
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
PATCH/api/users/{user_id}/identity

Update identity properties using JSON Merge Patch (RFC 7396). Modify profile attributes or clear PII for data regulation compliance. More Privacy

Body application/json
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
Responses
200application/json
OK
schemaobject
dataallOfrequired
Variant
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
UserIdentityUserIdentity
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
idstringrequired
Unique identifier for a user.
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
Option 2object
userUserrequired
Nested fields truncated. Expand to continue inline, or use the model link.
A user within an application who can authenticate and access resources. Users belong to an Application and access Accounts via memberships.
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/users/{user_id}/identity

Recreate a user identity that was previously deleted. Useful for restoring PII after compliance-related deletion. More Privacy

Body application/json
avatar_urlstring · uri
external_idstring
given_namestring
family_namestring
display_namestring
preferred_languagestring
localestring
timezonestring
Responses
200application/json
OK
schemaobject
dataallOfrequired
Variant
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
UserIdentityUserIdentity
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
idstringrequired
Unique identifier for a user.
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
Option 2object
userUserrequired
Nested fields truncated. Expand to continue inline, or use the model link.
A user within an application who can authenticate and access resources. Users belong to an Application and access Accounts via memberships.
linksobjectrequired
selfstringrequired
URL of the created resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/users/{user_id}/memberships

List all memberships for a user across accounts. Returns the accounts and roles associated with each membership. More Applications

Responses
200application/json
OK
schemaobject
dataarrayrequired
itemallOfrequired
Variant
Links a user to an account with a specific role (owner, member, or viewer). Users can have memberships in multiple accounts.
MembershipMembership
Nested fields truncated. Expand to continue inline, or use the model link.
Links a user to an account with a specific role (owner, member, or viewer). Users can have memberships in multiple accounts.
Option 2object
Nested fields truncated. Expand to continue inline, or use the model link.
linksobjectrequired
selfstringrequired
URL of the current page
nextstring
URL of the next page
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring

Models

Account
idstringrequired
Unique identifier for an account.
parent_idstring | nullrequired
Parent resource ID (application ID for accounts).
Variant
Unique identifier for an account.
Option 1string
Unique identifier for an account.
Unique identifier for an application.
Option 2string
Unique identifier for an application.
namestring | null
Display name for the account.
avatar_urlstring · uri | null
URL to the account's avatar image.
EmailAddress
string · email
A valid, normalized email address.
EmailCredential
idstringrequired
user_idstringrequired
Unique identifier for a user.
emailEmailAddress | nullEmailAddress
A valid, normalized email address.
hashed_emailstring | null
email_verified_atstring | null
FileMultipartAbortResponse
upload_idstringrequired
keystringrequired
Membership
idstringrequired
Unique identifier for a membership.
account_idstringrequired
Unique identifier for an account.
user_idstringrequired
Unique identifier for a user.
rolerequired
ProblemDetails
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
Profile
idstringrequired
Unique identifier for a user.
application_idstringrequired
Unique identifier for an application.
statusrequired
credentialsarrayrequired
itemEmailCredentialrequired
Associates an email address with a user for authentication. Used to look up users during login flows and verify email ownership.
idstringrequired
user_idstringrequired
Unique identifier for a user.
emailEmailAddress | nullEmailAddress
A valid, normalized email address.
hashed_emailstring | null
email_verified_atstring | null
membershipsarrayrequired
itemallOfrequired
Variant
Links a user to an account with a specific role (owner, member, or viewer). Users can have memberships in multiple accounts.
MembershipMembership
Links a user to an account with a specific role (owner, member, or viewer). Users can have memberships in multiple accounts.
idstringrequired
Unique identifier for a membership.
account_idstringrequired
Unique identifier for an account.
user_idstringrequired
Unique identifier for a user.
rolerequired
Option 2object
accountAccountrequired
Nested fields truncated. Expand to continue inline, or use the model link.
Represents a billing container with domains and billing settings. Accounts form a hierarchy with applications where types alternate.
identityUserIdentity | nullUserIdentityrequired
Personal profile information for a user including name, avatar, and locale preferences. Stored separately from authentication data for GDPR compliance.
idstringrequired
Unique identifier for a user.
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
S3FileMetadata
keystringrequired
pathstringrequired
size_bytesnumberrequired
etagstring | nullrequired
last_modifiedstring · date-timerequired
storage_classstring | nullrequired
S3FileMultipartCompleteResponse
upload_idstringrequired
keystringrequired
etagstring
locationstring
S3FileMultipartInitResponse
upload_idstringrequired
keystringrequired
S3FilePresignResponse
urlstring · urirequired
headersobject
expires_atstring · date-timerequired
User
idstringrequired
Unique identifier for a user.
application_idstringrequired
Unique identifier for an application.
statusrequired
UserIdentity
idstringrequired
Unique identifier for a user.
avatar_urlstring · uri | null
external_idstring | null
given_namestring | null
family_namestring | null
display_namestring | null
preferred_languagestring | null
localestring | null
timezonestring | null
ValidationProblemDetails
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring