project_idstringrequired
The ID of the project.
service_account_idstringrequired
The ID of the service account.
Deletes a service account from the project.
delete
https://api.openai.com/v1/organization/projects/{project_id}/service_accounts/{service_account_id}
Path Parameters
Response
200 application/json
Response
200 application/json
Project service account deleted successfully.
ProjectServiceAccountDeleteResponse
objectstringrequired
Allowed values:organization.project.service_account.deleted
idstringrequired
deletedbooleanrequired
delete/organization/projects/{project_id}/service_accounts/{service_account_id}
Authentication
Path Parameters
200 application/json
Returns a list of users in the project.
get
https://api.openai.com/v1/organization/projects/{project_id}/users
Query Parameters
limitinteger
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
Default:20
afterstring
A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
Path Parameters
project_idstringrequired
The ID of the project.
Response
application/json
Response
application/json
Project users listed successfully.
ProjectUserListResponse
objectstringrequired
dataarray[object]required
Represents an individual user in a project.
Show Child Parameters
first_idstringrequired
last_idstringrequired
has_morebooleanrequired
get/organization/projects/{project_id}/users
Authentication
Path Parameters
Query Parameters
application/json
Adds a user to the project. Users must already be members of the organization to be added to a project.
post
https://api.openai.com/v1/organization/projects/{project_id}/users
Path Parameters
project_idstringrequired
The ID of the project.
Body
application/json
Body
application/json
The project user create request payload.
ProjectUserCreateRequest
user_idstringrequired
The ID of the user.
rolestringrequired
owner or member
Allowed values:ownermember
Response
application/json
Response
application/json
User added to project successfully.
ProjectUser
Represents an individual user in a project.
objectstringrequired
The object type, which is always organization.project.user
Allowed values:organization.project.user
idstringrequired
The identifier, which can be referenced in API endpoints
namestringrequired
The name of the user
emailstringrequired
The email address of the user
rolestringrequired
owner or member
Allowed values:ownermember
added_atintegerrequired
The Unix timestamp (in seconds) of when the project was added.
post/organization/projects/{project_id}/users
Authentication
Path Parameters
Body
{
"user_id": "user_id",
"role": "owner"
}
application/json
Retrieves a user in the project.
get
https://api.openai.com/v1/organization/projects/{project_id}/users/{user_id}
Path Parameters
project_idstringrequired
The ID of the project.
user_idstringrequired
The ID of the user.
Response
200 application/json
Response
200 application/json
Project user retrieved successfully.
ProjectUser
Represents an individual user in a project.
objectstringrequired
The object type, which is always organization.project.user
Allowed values:organization.project.user
idstringrequired
The identifier, which can be referenced in API endpoints
namestringrequired
The name of the user
emailstringrequired
The email address of the user
rolestringrequired
owner or member
Allowed values:ownermember
added_atintegerrequired
The Unix timestamp (in seconds) of when the project was added.
get/organization/projects/{project_id}/users/{user_id}
Authentication
Path Parameters
200 application/json
Modifies a user's role in the project.
post
https://api.openai.com/v1/organization/projects/{project_id}/users/{user_id}
Path Parameters
project_idstringrequired
The ID of the project.
user_idstringrequired
The ID of the user.
Body
application/json
Body
application/json
The project user update request payload.
ProjectUserUpdateRequest
rolestringrequired
owner or member
Allowed values:ownermember
Response
application/json
Response
application/json
Project user’s role updated successfully.
ProjectUser
Represents an individual user in a project.
objectstringrequired
The object type, which is always organization.project.user
Allowed values:organization.project.user
idstringrequired
The identifier, which can be referenced in API endpoints
namestringrequired
The name of the user
emailstringrequired
The email address of the user
rolestringrequired
owner or member
Allowed values:ownermember
added_atintegerrequired
The Unix timestamp (in seconds) of when the project was added.
post/organization/projects/{project_id}/users/{user_id}
Authentication
Path Parameters
Body
{
"role": "owner"
}
application/json