List projects
List all of the projects for an organization.
Query Parameters
A base64 encoded cursor that can be used to paginate results. Must match the pattern ^[\w-+/=]+$
.
The maximum number of results to return. Must be between 1
and 240
.
A base64 encoded cursor that can be used to paginate results. One of created_at
, -created_at
, +created_at
, created_at
.
Responses
200 OK response.
An array of results.
Show attributes
Whether or not the project has established a connection to a cloud provider. One of connected
, disconnected
, disconnecting
.
The time the org was created.
The ID of the default environment for the project. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
A short description of the project.
An icon for the project.
The ID of the repo. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the project.
The ID of the organization the project belongs to. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Whether there are more results available.
The cursor for the next page of results as a base64 encoded string. Must match the pattern ^[a-zA-Z0-9+/=]+$
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Create a project
Create a new project.
Request Body
Must match the pattern ^(icon|emoji|url):(.+)$
.
Responses
201 Created response.
Whether or not the project has established a connection to a cloud provider. One of connected
, disconnected
, disconnecting
.
The time the org was created.
The ID of the default environment for the project. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
A short description of the project.
An icon for the project.
The ID of the repo. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the project.
The ID of the organization the project belongs to. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Get a project
Get a project by its ID.
Path Parameters
The ID of the project to get. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
200 OK response.
Whether or not the project has established a connection to a cloud provider. One of connected
, disconnected
, disconnecting
.
The time the org was created.
The ID of the default environment for the project. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
A short description of the project.
An icon for the project.
The ID of the repo. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the project.
The ID of the organization the project belongs to. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Update a project
Update a project by its ID.
Path Parameters
The ID of the project. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Request Body
Important note
PUT
requests are used to replace an existing resource.
The request body should contain the full representation of the
resource, including any fields that are not being updated.
Set the default project environment. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Must match the pattern ^(icon|emoji|url):(.+)$
.
Responses
200 OK response.
Whether or not the project has established a connection to a cloud provider. One of connected
, disconnected
, disconnecting
.
The time the org was created.
The ID of the default environment for the project. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
A short description of the project.
An icon for the project.
The ID of the repo. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the project.
The ID of the organization the project belongs to. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Delete a project
Delete a project by its ID.
Path Parameters
The ID of the project to delete. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
204
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
List project collaborators
List all of the members of an project.
Path Parameters
The project ID to look up. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Query Parameters
The role of the members to list.
A base64 encoded cursor that can be used to paginate results. Must match the pattern ^[\w-+/=]+$
.
The maximum number of results to return. Must be between 1
and 240
.
A base64 encoded cursor that can be used to paginate results. One of created_at
, -created_at
, +created_at
, created_at
.
Responses
200 OK response.
An array of results.
Show attributes
The account ID of the member. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The avatar of the member.
The time the member was created.
The display name of the member.
The ID of the membership. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the member.
The role of the member within the org. One of owner
, admin
, member
.
Describes the profile of an org.
Show attributes
The bio of the org.
The GitHub handle of the org.
The location of the org.
The Twitter handle of the org.
The website of the org.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The role of the member within the project. One of owner
, contributor
, viewer
.
Whether there are more results available.
The cursor for the next page of results as a base64 encoded string. Must match the pattern ^[a-zA-Z0-9+/=]+$
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Create an project collaborator
Add members to an project.
Path Parameters
The project ID to add members to. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Request Body
The member ID to look up. Must contain between 1
and 100
items.
Responses
201 Created response.
The account ID of the member. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The avatar of the member.
The time the member was created.
The display name of the member.
The ID of the membership. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the member.
The role of the member within the org. One of owner
, admin
, member
.
Describes the profile of an org.
Show attributes
The bio of the org.
The GitHub handle of the org.
The location of the org.
The Twitter handle of the org.
The website of the org.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The role of the member within the project. One of owner
, contributor
, viewer
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
List projects by organization
List all of the projects for an organization.
Path Parameters
The organization ID to scope the project to. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Query Parameters
A base64 encoded cursor that can be used to paginate results. Must match the pattern ^[\w-+/=]+$
.
The maximum number of results to return. Must be between 1
and 240
.
A base64 encoded cursor that can be used to paginate results. One of created_at
, -created_at
, +created_at
, created_at
.
Responses
200 OK response.
An array of results.
Show attributes
Whether or not the project has established a connection to a cloud provider. One of connected
, disconnected
, disconnecting
.
The time the org was created.
The ID of the default environment for the project. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
A short description of the project.
An icon for the project.
The ID of the repo. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the project.
The ID of the organization the project belongs to. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Whether there are more results available.
The cursor for the next page of results as a base64 encoded string. Must match the pattern ^[a-zA-Z0-9+/=]+$
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Disconnect a project
Disconnect a project from the cloud provider.
Path Parameters
The ID of the project to disconnect. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
204
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Get an project collaborator
Get a member of an project by ID.
Path Parameters
The project ID to look up. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The member ID to look up. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
200 OK response.
The account ID of the member. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The avatar of the member.
The time the member was created.
The display name of the member.
The ID of the membership. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the member.
The role of the member within the org. One of owner
, admin
, member
.
Describes the profile of an org.
Show attributes
The bio of the org.
The GitHub handle of the org.
The location of the org.
The Twitter handle of the org.
The website of the org.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The role of the member within the project. One of owner
, contributor
, viewer
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Update an project collaborator
Update a member of an project.
Path Parameters
The project ID to look up. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The member ID to look up. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Request Body
Important note
PUT
requests are used to replace an existing resource.
The request body should contain the full representation of the
resource, including any fields that are not being updated.
The role of the member within the project. One of owner
, contributor
, viewer
.
Responses
200 OK response.
The account ID of the member. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The avatar of the member.
The time the member was created.
The display name of the member.
The ID of the membership. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The name of the member.
The role of the member within the org. One of owner
, admin
, member
.
Describes the profile of an org.
Show attributes
The bio of the org.
The GitHub handle of the org.
The location of the org.
The Twitter handle of the org.
The website of the org.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The role of the member within the project. One of owner
, contributor
, viewer
.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Delete an project collaborator
Delete a member of an project.
Path Parameters
The project ID to look up. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The member ID to look up. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
204
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
List notifications integrations
List the notifications integrations for a project.
Path Parameters
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
200 OK response.
The configuration of the integration.
The time the integration was created.
The ID of the integration. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Show attributes
Deployments failed notification is enabled.
Deployments in progress notification is enabled.
Deployments succeeded notification is enabled.
Changelog notification is enabled.
Promotions notification is enabled.
Services in alarm notification is enabled.
Services OK notification is enabled.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The type of integration. One of slack
, webhook
.
The time the integration was updated.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Create a notifications integration
Create a notifications integration for a project.
Path Parameters
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Request Body
The configuration of the integration.
Show attributes
Show attributes
Deployments failed notification is enabled.
Deployments in progress notification is enabled.
Deployments succeeded notification is enabled.
Changelog notification is enabled.
Promotions notification is enabled.
Services in alarm notification is enabled.
Services OK notification is enabled.
The type of integration. One of webhook
.
Responses
201 Created response.
The configuration of the integration.
The time the integration was created.
The ID of the integration. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Show attributes
Deployments failed notification is enabled.
Deployments in progress notification is enabled.
Deployments succeeded notification is enabled.
Changelog notification is enabled.
Promotions notification is enabled.
Services in alarm notification is enabled.
Services OK notification is enabled.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The type of integration. One of slack
, webhook
.
The time the integration was updated.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Get a notifications integration
Get the notifications integration for a project.
Path Parameters
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The integration ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
200 OK response.
The configuration of the integration.
The time the integration was created.
The ID of the integration. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Show attributes
Deployments failed notification is enabled.
Deployments in progress notification is enabled.
Deployments succeeded notification is enabled.
Changelog notification is enabled.
Promotions notification is enabled.
Services in alarm notification is enabled.
Services OK notification is enabled.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The type of integration. One of slack
, webhook
.
The time the integration was updated.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Update a notifications integration
Update a notifications integration for a project.
Path Parameters
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The integration ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Request Body
Show attributes
Deployments failed notification is enabled.
Deployments in progress notification is enabled.
Deployments succeeded notification is enabled.
Changelog notification is enabled.
Promotions notification is enabled.
Services in alarm notification is enabled.
Services OK notification is enabled.
Responses
200 OK response.
The configuration of the integration.
The time the integration was created.
The ID of the integration. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Show attributes
Deployments failed notification is enabled.
Deployments in progress notification is enabled.
Deployments succeeded notification is enabled.
Changelog notification is enabled.
Promotions notification is enabled.
Services in alarm notification is enabled.
Services OK notification is enabled.
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The type of integration. One of slack
, webhook
.
The time the integration was updated.
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
Delete a notifications integration
Delete a notifications integration for a project.
Path Parameters
The project ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
The integration ID. Must match the pattern (^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$)|(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)
.
Responses
204
400 Bad Request response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
401 Unauthorized response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
403 Forbidden response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
404 Not Found response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
408 Request Timeout response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
409 Conflict response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
429 Too Many Requests response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
500 Internal Server Error response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
501 Not Implemented response.
The cause of the error.
The code of the error. One of bad_input
, forbidden
, unauthenticated
, unauthorized
, not_implemented
, internal
, not_found
, conflict
, timeout
, rate
.
The message of the error.
API Reference
Explore the API reference by resource type