# Participations

A participation represents the relationship between a participant and a project, including a participant's permission level,
whether they're a provider or client, and many other properties. See the 200 status code
response sample for an example of participation properties you can access.

## Fetching a list of Participations

 - [GET /participations](https://developer.kantata.com/kantata/specification/participations/get-participations.md): The Participations index action only returns participations from projects that are visible to the requester.
See the Projects KB documentation for more information about how visibility restrictions work.


This endpoint returns structured Participation objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the participations top-level JSON key.
Please see our Response Format section for more information.

## Creating a new Participation

 - [POST /participations](https://developer.kantata.com/kantata/specification/participations/create-participation.md): Adds a user to a project (workspace).

Bulk Create

This endpoint supports bulk creating up to 100 objects. In the request body, set the top-level key to its plural form and place the objects in an array. Example:


{
  "participations": [
    {
      "workspace_id": 123,
      "role": "maven",
      "user_id": 111
    },
    {
      "workspace_id": 123,
      "role": "maven",
      "user_id": 222
    }
  ]
}



This endpoint returns structured Participation objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the participations top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single Participation

 - [GET /participations/{id}](https://developer.kantata.com/kantata/specification/participations/get-participation.md): This endpoint returns structured Participation objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the participations top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing Participation

 - [PUT /participations/{id}](https://developer.kantata.com/kantata/specification/participations/update-participation.md): This endpoint returns structured Participation objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the participations top-level JSON key.
Please see our Response Format section for more information.

## Deleting an existing Participation

 - [DELETE /participations/{id}](https://developer.kantata.com/kantata/specification/participations/delete-participation.md): Removes a participant from a project and deletes their associated project data.


The response will contain no content and an HTTP 204 status code if the request was
successful, or a standard Kantata OX error message explaining why the object could not be deleted.