Prolific workspaces API
The workspaces API from Prolific — 3 operation(s) for workspaces.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/prolific-workspaces-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Reference aiTaskBuilder Workspaces API
version: 1.0.0
servers:
- url: https://api.prolific.com
description: Production
tags:
- name: workspaces
paths:
/api/v1/workspaces/:
get:
operationId: get-workspaces
summary: Get all a user's workspaces
description: Gets a list of all workspaces that the user is a member of.
tags:
- workspaces
parameters:
- name: Authorization
in: header
description: 'The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add `Authorization` header with the value `Token <your token>`.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/WorkspacesListResponse'
'400':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
operationId: create-workspace
summary: Create a workspace
description: Creates a new workspace and adds the user as a Workspace Admin.
tags:
- workspaces
parameters:
- name: Authorization
in: header
description: 'The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add `Authorization` header with the value `Token <your token>`.'
required: true
schema:
type: string
responses:
'201':
description: Created workspace
content:
application/json:
schema:
$ref: '#/components/schemas/Workspace'
'400':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateWorkspace'
/api/v1/workspaces/{workspace_id}/:
get:
operationId: get-workspace
summary: Get workspace
description: Gets a workspace's details
tags:
- workspaces
parameters:
- name: workspace_id
in: path
description: Workspace id
required: true
schema:
type: string
- name: Authorization
in: header
description: 'The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add `Authorization` header with the value `Token <your token>`.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/Workspace'
'400':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
patch:
operationId: update-workspace
summary: Update a workspace
description: Updates a workspace's details.
tags:
- workspaces
parameters:
- name: workspace_id
in: path
description: Workspace id
required: true
schema:
type: string
- name: Authorization
in: header
description: 'The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add `Authorization` header with the value `Token <your token>`.'
required: true
schema:
type: string
responses:
'200':
description: Updated workspace redirect link
content:
application/json:
schema:
$ref: '#/components/schemas/Workspace'
'400':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Workspace'
/api/v1/workspaces/{workspace_id}/balance/:
get:
operationId: get-workspace-balance
summary: Get the balance of a workspace
description: Provides details of the funds available in the workspace.
tags:
- workspaces
parameters:
- name: workspace_id
in: path
description: Workspace id
required: true
schema:
type: string
- name: Authorization
in: header
description: 'The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add `Authorization` header with the value `Token <your token>`.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/WorkspaceBalance'
'400':
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
PublicDetails:
type: object
properties:
status:
$ref: '#/components/schemas/PublicProjectStatus'
description: Status of the public project metadata. Defaults to `ENABLED`.
title:
type: string
description: Participant-facing title for the public project.
short_description:
type: string
description: Short participant-facing summary shown to participants for the public project.
description:
type: string
description: Additional participant-facing information shown to participants for the public project.
title: PublicDetails
ProjectType:
type: string
enum:
- PRIVATE
- PUBLIC
description: Project visibility type.
title: ProjectType
WorkspaceShort:
type: object
properties:
id:
type: string
description: Workspace id. It is created by Prolific.
title:
type: string
description: Name of workspace
description:
type: string
description: What is this workspace used for
owner:
type: string
description: User id of the creator of the workspace. It is created by Prolific.
users:
type: array
items:
$ref: '#/components/schemas/WorkspaceUser'
description: Data for all users who have access to this workspace
naivety_distribution_rate:
type:
- number
- 'null'
format: double
description: The rate at which the studies within this project are distributed.
required:
- id
- title
title: WorkspaceShort
WorkspacesListResponse:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/WorkspaceShort'
description: List of all workspaces for user
required:
- results
title: WorkspacesListResponse
ProjectShort:
type: object
properties:
id:
type: string
description: Project id. It is created by Prolific.
title:
type: string
description: Name of project
description:
type: string
description: What is this project used for
owner:
type: string
description: User id of the creator of the project. It is created by Prolific.
type:
$ref: '#/components/schemas/ProjectType'
public_details:
oneOf:
- $ref: '#/components/schemas/PublicDetails'
- type: 'null'
description: Public metadata for `PUBLIC` projects. `null` for `PRIVATE` projects.
users:
type: array
items:
$ref: '#/components/schemas/WorkspaceUser'
description: Data for all users who have access to this project
naivety_distribution_rate:
type:
- number
- 'null'
format: double
description: The rate at which the studies within this project are distributed.
required:
- id
- title
- type
title: ProjectShort
CreateWorkspace:
type: object
properties:
title:
type: string
description: Name of workspace
naivety_distribution_rate:
type:
- number
- 'null'
format: double
description: 'Control the balance between speed of your studies and the naivety of the participants.
If not defined, by default Prolific calculates the best rate for most studies
taking into account the `filters` and the `total_available_places` needed for this study.
Use 0 if your priority is speed. When this property is set to 0 all eligible participants will have access
to your study at the same time, without any prioritization.
You can also set this at a project and study level.'
currency_code:
type: string
description: Currency used for all transactions within the workspace. Must be GBP or USD.
required:
- title
title: CreateWorkspace
WorkspaceUser:
type: object
properties:
id:
type: string
description: Id of user
name:
type: string
description: Name of user
email:
type: string
description: email of user
roles:
type: array
items:
type: string
description: User roles in workspace
required:
- id
title: WorkspaceUser
PublicProjectStatus:
type: string
enum:
- ENABLED
- DISABLED
description: Participant-facing publication status for a public project.
title: PublicProjectStatus
Workspace:
type: object
properties:
id:
type: string
description: Workspace id. It is created by Prolific.
title:
type: string
description: Name of workspace
description:
type: string
description: What is this workspace used for
owner:
type: string
description: Workspace id. It is created by Prolific.
users:
type: array
items:
$ref: '#/components/schemas/WorkspaceUser'
description: Data for a user related to a workspace
projects:
type: array
items:
$ref: '#/components/schemas/ProjectShort'
description: Data for a project related to a workspace
wallet:
type: string
description: Wallet tied to workspace
naivety_distribution_rate:
type:
- number
- 'null'
format: double
description: The rate at which the studies within this workspace are distributed.
required:
- id
- title
title: Workspace
ErrorDetailDetail:
oneOf:
- type: string
- type: array
items:
type: string
- $ref: '#/components/schemas/ErrorDetailDetail2'
description: Error detail
title: ErrorDetailDetail
ErrorDetailDetail2:
type: object
properties:
any_field:
type: array
items:
type: string
description: Name of the field with a validation error and as a value an array with the error descriptions
description: All fields with validation errors
title: ErrorDetailDetail2
WorkspaceBalance:
type: object
properties:
currency_code:
type: string
description: The currency used for all financial transactions within the workspace.
total_balance:
type: integer
description: 'The total balance of the workspace, including funds which have already been assigned to active studies.
All monetary values are shown in the sub-currency of your workspace currency (e.g. pence, cents).'
balance_breakdown:
$ref: '#/components/schemas/WorkspaceBalanceBalanceBreakdown'
description: 'A breakdown of the total balance of the workspace into:
- Funds available to pay to participants
- Funds pre-paid to Prolific for our services
- Funds for any VAT applied to our Platform fees'
available_balance:
type: integer
description: The remaining balance of your workspace which is available to spend, after removing funds assigned to already active studies, etc.
available_balance_breakdown:
$ref: '#/components/schemas/WorkspaceBalanceAvailableBalanceBreakdown'
description: 'A breakdown of the available balance of the workspace into:
- Funds available to pay to participants
- Funds pre-paid to Prolific for our services
- Funds for any VAT applied to our Platform fees'
title: WorkspaceBalance
WorkspaceBalanceAvailableBalanceBreakdown:
type: object
properties: {}
description: 'A breakdown of the available balance of the workspace into:
- Funds available to pay to participants
- Funds pre-paid to Prolific for our services
- Funds for any VAT applied to our Platform fees'
title: WorkspaceBalanceAvailableBalanceBreakdown
ErrorDetail:
type: object
properties:
status:
type: integer
description: Status code as in the http standards
error_code:
type: integer
description: Internal error code
title:
type: string
description: Error title
detail:
$ref: '#/components/schemas/ErrorDetailDetail'
description: Error detail
additional_information:
type: string
description: Optional extra information
traceback:
type: string
description: Optional debug information
interactive:
type: boolean
required:
- status
- error_code
- title
- detail
title: ErrorDetail
Error:
type: object
properties:
error:
$ref: '#/components/schemas/ErrorDetail'
required:
- error
title: Error
WorkspaceBalanceBalanceBreakdown:
type: object
properties: {}
description: 'A breakdown of the total balance of the workspace into:
- Funds available to pay to participants
- Funds pre-paid to Prolific for our services
- Funds for any VAT applied to our Platform fees'
title: WorkspaceBalanceBalanceBreakdown
securitySchemes:
token:
type: apiKey
in: header
name: Authorization
description: 'The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add `Authorization` header with the value `Token <your token>`.'