# Productive API

> Productive is a Professional Services Automation platform. This file is a machine-readable index following https://llmstxt.org. Use the filtered OpenAPI spec URLs below to fetch full schemas and examples for any resource group. For the complete resource map see https://developer.productive.io/llms-full.txt

Base URL: https://api.productive.io/api/v2/

## Auth (required on every request)
X-Auth-Token: {token}  (Settings → API integrations → Generate new token)
X-Organization-Id: {org_id}  (numeric, from your Productive URL)
Content-Type: application/vnd.api+json  (required on POST/PATCH/DELETE)
401 = unauthenticated | 403 = unauthorized

## OpenAPI Spec
Full YAML: https://developer.productive.io/reference/download_spec
Full JSON:  https://developer.productive.io/reference/download_spec?format=json

Filter params — append any combination to the spec URL:
  ?category={slug}                      all endpoints in a category
  ?group={slug}                         all endpoints for one resource
  ?path=/api/v2/tasks                   all methods on a path
  ?path=/api/v2/tasks&method=post       single operation

## Categories
  Organization (organization): https://developer.productive.io/reference/download_spec?category=organization
  Core Resources (core): https://developer.productive.io/reference/download_spec?category=core
  Projects (project-management): https://developer.productive.io/reference/download_spec?category=project-management
  Tasks (tasks): https://developer.productive.io/reference/download_spec?category=tasks
  Docs (docs): https://developer.productive.io/reference/download_spec?category=docs
  Forms (forms): https://developer.productive.io/reference/download_spec?category=forms
  Time Tracking (time-tracking): https://developer.productive.io/reference/download_spec?category=time-tracking
  Financials (financials): https://developer.productive.io/reference/download_spec?category=financials
  Invoicing (invoicing): https://developer.productive.io/reference/download_spec?category=invoicing
  Resource Management (resource-management): https://developer.productive.io/reference/download_spec?category=resource-management
  CRM (crm): https://developer.productive.io/reference/download_spec?category=crm
  Reporting (reports): https://developer.productive.io/reference/download_spec?category=reports

## Conventions
Format: JSON:API — body: {"data":{"type":"tasks","attributes":{},"relationships":{}}}
Filter:   ?filter[field]=value  e.g. ?filter[assignee_id]=42
Paginate: ?page[number]=1&page[size]=30  (max 200)
Sort:     ?sort=name  or  ?sort=-name (descending)
Rate:     100 req/10s, 4000 req/30min; reports: 10 req/30s; HTTP 429 on excess

## Create a task
curl -X POST https://api.productive.io/api/v2/tasks \
  -H "X-Auth-Token: TOKEN" -H "X-Organization-Id: ORG_ID" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{"data":{"type":"tasks","attributes":{"title":"My task"},"relationships":{"task_list":{"data":{"type":"task_lists","id":"123"}}}}}'

## Log time (time in minutes; requires person_id + service_id)
curl -X POST https://api.productive.io/api/v2/time_entries \
  -H "X-Auth-Token: TOKEN" -H "X-Organization-Id: ORG_ID" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{"data":{"type":"time_entries","attributes":{"date":"2024-01-15","time":60},"relationships":{"person":{"data":{"type":"people","id":"456"}},"service":{"data":{"type":"services","id":"789"}}}}}'

Time entry fields: https://developer.productive.io/reference/download_spec?group=time-entries
Changelog: https://developer.productive.io/reference/changelog

## Guides
- [Overview](https://developer.productive.io/guides/overview)
- [Authorization](https://developer.productive.io/guides/authorization)
- [Document Format](https://developer.productive.io/guides/document-format)
- [Content Negotiation](https://developer.productive.io/guides/content-negotiation)
- [Filtering](https://developer.productive.io/guides/filtering)
- [Error Handling](https://developer.productive.io/guides/error-handling)
- [Sorting](https://developer.productive.io/guides/sorting)
- [FAQ](https://developer.productive.io/guides/faq)
- [Importing Docs via API](https://developer.productive.io/guides/importing-docs-via-api)
- [Pagination](https://developer.productive.io/guides/pagination)
- [Resource Representation](https://developer.productive.io/guides/resource-representation)
- [API changes](https://developer.productive.io/guides/api-changes)
- [Rate Limits](https://developer.productive.io/guides/rate-limits)
- [Working with attachments](https://developer.productive.io/guides/working-with-attachments)
- [Working with custom fields](https://developer.productive.io/guides/working-with-custom-fields)