OpenAI API (unofficial showcase)
POST/organization/projects/{project_id}/users

Create project user

Adds a user to the project. Users must already be members of the organization to be added to a project.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
project_idstringrequired
The ID of the project.

The project user create request payload.

user_idstringoptional
The ID of the user.
emailstringoptional
Email of the user to add.
rolestringrequired
`owner` or `member`

7 status codes
200User added to project successfully.
objectstringrequired
The object type, which is always `organization.project.user`
Allowed:organization.project.user
idstringrequired
The identifier, which can be referenced in API endpoints
namestringoptional
The name of the user
emailstringoptional
The email address of the user
rolestringrequired
`owner` or `member`
added_atintegerrequired
The Unix timestamp (in seconds) of when the project was added.
201User added to project successfully.
objectstringrequired
The object type, which is always `organization.project.user`
Allowed:organization.project.user
idstringrequired
The identifier, which can be referenced in API endpoints
namestringoptional
The name of the user
emailstringoptional
The email address of the user
rolestringrequired
`owner` or `member`
added_atintegerrequired
The Unix timestamp (in seconds) of when the project was added.
400The request is invalid or the user cannot be added to the project in its current state.
errorobjectrequired
403The caller lacks the required permissions.
errorobjectrequired
Details about the permission error.
404The project or user was not found in the organization.
errorobjectrequired
409The request conflicts with the current state of the resource.
errorobjectrequired
429The request exceeded the rate limit.
errorobjectrequired

Error handling

A 400 is returned: The request is invalid or the user cannot be added to the project in its current state. A 403 is returned: The caller lacks the required permissions. A 404 is returned: The project or user was not found in the organization. A 409 is returned: The request conflicts with the current state of the resource. A 429 is returned: The request exceeded the rate limit.