Grant a vector store permission
Grants reader or writer on the vector store to one principal, or to every member of the store’s team (grantee_type: team), replacing any role that principal already held. Only the store’s owner or an organization admin of its team can grant (403 otherwise). The owner’s role is fixed at creation and cannot be granted or changed. Returns 410 once the vector store has expired.
Authorizations
Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.
Headers
Optional external end-user identifier forwarded by the API gateway.
Path Parameters
The ID of the vector store.
Body
- Option 1
- Option 2
Grants a role on the store, replacing any role the principal already holds. grantee_type defaults to user.
Grants to one principal.
A member's user id, or the end-user id a request is delegated to with X-On-Behalf-Of. May not contain / or whitespace, and may not be ., .., * or team.
1The role to grant. writer includes reader.
writer, reader Response
OK
A role held on a vector store by a principal, or by every member of the store's team.
The object type, which is always 'vector_store.permission'.
The ID of the vector store the permission applies to.
Who the permission applies to: one principal (user), or every member of the store's team (team).
user, team The principal the permission applies to: a member's user id, or the end-user id a request is delegated to with X-On-Behalf-Of. null when the permission applies to the store's team.
The role held on the store. owner is the store's creator and cannot be granted; writer includes reader.
owner, writer, reader