post/vault/share

Request

  • Base URL: https://api.useanima.sh/v1
  • URL: https://api.useanima.sh/v1/vault/share
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

credentialIdstring required

ID of the credential to share

permission'READ' | 'USE' | 'MANAGE'

Permission level for the share

expiresAtstring date-time

Optional expiration time for the share

expiresInSecondsinteger

Relative TTL in seconds — alternative to expiresAt. Max 1 year.

Response

OK

idstring required

Unique share record identifier

credentialIdstring required

Shared credential identifier

orgIdstring required

Organization identifier

sourceAgentIdstring required

Agent that owns the credential

targetAgentIdstring required

Agent that received access

permission'READ' | 'USE' | 'MANAGE' required

Permission level

expiresAtstring date-time nullable required

When the share expires

grantedBystring required

Who created the share

revokedAtstring date-time nullable required

When the share was revoked, if applicable

createdAtstring date-time required

Timestamp when the share was created

updatedAtstring date-time required

Timestamp when the share was last updated

Changes

No recorded changes to this operation across all 1 revision of this API.