curl --request POST \
  --url https://app.dotportion.com/api/v1/assessments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "challenge_id": "00000000-0000-4000-8000-000000000001",
  "name": "Backend hire — Q1"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    challenge_id: '00000000-0000-4000-8000-000000000001',
    name: 'Backend hire — Q1'
  })
};

fetch('https://app.dotportion.com/api/v1/assessments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.dotportion.com/api/v1/assessments"

payload = {
    "challenge_id": "00000000-0000-4000-8000-000000000001",
    "name": "Backend hire — Q1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "id": "00000000-0000-4000-8000-0000000000a1",
    "name": "Backend hire — Q1",
    "challenge_id": "00000000-0000-4000-8000-000000000001",
    "status": "active",
    "time_limit_minutes": 60,
    "budget_dollars_cap": null,
    "selected_task_ids": null,
    "created_at": "2026-01-15T12:00:00.000Z",
    "updated_at": "2026-01-15T12:00:00.000Z"
  },
  "meta": {
    "request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
  }
}

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Invalid request",
    "details": {
      "formErrors": [],
      "fieldErrors": {
        "name": [
          "String must contain at least 1 character(s)"
        ]
      }
    },
    "request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
  }
}

{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Invalid or revoked API key",
    "request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
  }
}

{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "This API key lacks the required scope: write.",
    "request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded for write requests (200/hour). Retry after 2026-01-15T13:00:00.000Z.",
    "details": {
      "limit": 200,
      "remaining": 0,
      "reset": 1768482000
    },
    "request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
  }
}