Update Talent Pool

PATCH

/api/v1/talent-pools/{talent_pool_id}/

Last modified:2025-06-02 14:39:13

Updates an existing talent pool for the authenticated company.

Arguments

talent_pool_id (string, as path parameter) : The unique identifier (hash) of the talent pool to update.

Example: talent_pool_id="d82f9a7c91b041b7b2b7612e"

name (string, as body parameter, optional) : The new name of the talent pool. If not provided, the existing name remains unchanged.

Example: "Updated Software Developer Talents"

Returns

200 OK : A success response indicating the talent pool was updated successfully.

Returns a JSON object with the details of the updated talent pool, including its ID, name, and update metadata.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟢204No Content

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.recruspace.com/api/v1/talent-pools//' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string"
}'

Response Example

{
    "id": 0,
    "candidate_count": 0,
    "created_by": {
        "id": 0,
        "user": {
            "id": 0,
            "email": "user@example.com",
            "first_name": "string",
            "last_name": "string",
            "profile_img": {
                "id": 0,
                "path": "string",
                "name": "string",
                "type": "string",
                "file_size": -2147483648,
                "base": "string",
                "presigned_url": "string",
                "uploaded_at": "2019-08-24T14:15:22Z"
            }
        },
        "permission": "owner",
        "role": "hiring_manager",
        "invite_status": "pending",
        "invite_code": "string",
        "invite_email": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "company": "string"
    },
    "name": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "company": "string"
}

Modified at 2025-06-02 14:39:13

Talent Pools

Delete Talent Pool