Teams

post/projects/{project_id}/access

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/projects/{project_id}/access
  • Auth: HTTP bearer

Path parameters

project_idinteger required

Request body

role'owner' | 'admin' | 'deployer' | 'viewer' required

Role a user holds within a team, or that a team holds on a project.

Named TeamRole rather than Role to keep it distinct from temps_auth::permissions::Role, which is the instance-wide role (Admin/User/…) attached to a session. The two are orthogonal: the instance-wide role decides whether you may touch a resource kind at all, TeamRole decides what you may do within a project you have team access to. See temps_teams::fixed_role_permissions for the project-scoped permission set each variant maps to.

Stored as a varchar(32) rather than a Postgres enum so the role set can evolve in pure migration code without a schema-level enum alteration blocking a downgrade.

team_idinteger required

Response

Access granted (idempotent upsert)

created_atstring date-time required
granted_byinteger required
idinteger required
project_idinteger required
role'owner' | 'admin' | 'deployer' | 'viewer' required

Role a user holds within a team, or that a team holds on a project.

Named TeamRole rather than Role to keep it distinct from temps_auth::permissions::Role, which is the instance-wide role (Admin/User/…) attached to a session. The two are orthogonal: the instance-wide role decides whether you may touch a resource kind at all, TeamRole decides what you may do within a project you have team access to. See temps_teams::fixed_role_permissions for the project-scoped permission set each variant maps to.

Stored as a varchar(32) rather than a Postgres enum so the role set can evolve in pure migration code without a schema-level enum alteration blocking a downgrade.

team_idinteger required
updated_atstring date-time required

Example response

{
  "created_at": "2026-07-30T12:15:47.609192Z",
  "updated_at": "2026-07-30T12:15:47.609192Z"
}

Changes

No recorded changes to this operation across all 53 revisions of this API.