{"openapi":"3.1.0","info":{"title":"Contentu API for agents","version":"1.0.0","description":"Public, read-only access to the Contentu portal (tools, remote jobs, blog, events, challenges, course catalogue) and, with an account key, to the caller's own profile, points and learning progress. The same operations are MCP tools at https://www.contentu.co/api/agents/mcp. Anonymous limit: 30 requests per minute per IP; with a key: 120 per minute. Docs: https://www.contentu.co/en/desarrolladores"},"servers":[{"url":"https://www.contentu.co/api/agents/v1"}],"paths":{"/tools":{"get":{"operationId":"list_tools","summary":"Search tools","description":"Search the Contentu directory of tools for freelancers, creators and vibe coders in Latin America. Order: tools recommended by Contentu first, then by name; never by money. When affiliate_link is true, show the disclosure text next to visit_url.","parameters":[{"name":"q","in":"query","required":false,"description":"Text to find in the name, description or tags","schema":{"type":"string","maxLength":80}},{"name":"category","in":"query","required":false,"description":"Exact category name","schema":{"type":"string","maxLength":80}},{"name":"pricing","in":"query","required":false,"schema":{"type":"string","enum":["free","freemium","paid","enterprise","unknown"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (max 50)","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page","schema":{"type":"string","maxLength":600}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/tools/{slug}":{"get":{"operationId":"get_tool","summary":"Get a tool","description":"One tool of the Contentu directory by slug. When affiliate_link is true, show the disclosure text next to visit_url.","parameters":[{"name":"slug","in":"path","required":true,"description":"The slug of the item, as returned by the list","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]*$"}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/jobs":{"get":{"operationId":"list_jobs","summary":"Search remote jobs","description":"Search remote job openings that accept people in Latin America, newest first. Seeing and applying is free: apply_url goes to the employer or to the source, never to a paywall. Always credit source.attribution when you show a job.","parameters":[{"name":"q","in":"query","required":false,"description":"Text to find in the title or the company","schema":{"type":"string","maxLength":80}},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["vibe-coding","automatizacion","programacion","producto-proyectos","contenido","marketing","diseno"]}},{"name":"eligibility","in":"query","required":false,"description":"Who may apply from Latin America","schema":{"type":"string","enum":["worldwide","latam","americas_tz"]}},{"name":"seniority","in":"query","required":false,"schema":{"type":"string","enum":["junior","mid","senior","lead"]}},{"name":"with_salary","in":"query","required":false,"description":"Only openings that publish a salary","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Items per page (max 50)","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page","schema":{"type":"string","maxLength":600}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/jobs/{id}":{"get":{"operationId":"get_job","summary":"Get a job","description":"One job opening by id, with its summary and the link to apply. status tells whether it is still open.","parameters":[{"name":"id","in":"path","required":true,"description":"The id of the job","schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/posts":{"get":{"operationId":"list_posts","summary":"List blog posts","description":"Posts of the Contentu blog, newest first (title, excerpt and tags; read one with get_post). Without a key: the free posts. With a key that has content:read and a Contentu Lab+ membership: member posts too.","parameters":[{"name":"q","in":"query","required":false,"description":"Text to find in the title or the excerpt","schema":{"type":"string","maxLength":80}},{"name":"tag","in":"query","required":false,"schema":{"type":"string","maxLength":60}},{"name":"limit","in":"query","required":false,"description":"Items per page (max 50)","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page","schema":{"type":"string","maxLength":600}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":["content:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/posts/{slug}":{"get":{"operationId":"get_post","summary":"Read a blog post","description":"The full text of a blog post in markdown. Long posts are cut at max_chars (truncated: true); the rest is at url.","parameters":[{"name":"slug","in":"path","required":true,"description":"The slug of the item, as returned by the list","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]*$"}},{"name":"max_chars","in":"query","required":false,"description":"Cut the long text at this many characters","schema":{"type":"integer","minimum":200,"maximum":120000}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":["content:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/events":{"get":{"operationId":"list_events","summary":"List events","description":"Public Contentu events (workshops, live sessions), earliest first. By default only the ones that have not ended.","parameters":[{"name":"when","in":"query","required":false,"description":"Default: upcoming","schema":{"type":"string","enum":["upcoming","past","all"]}},{"name":"limit","in":"query","required":false,"description":"Items per page (max 50)","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page","schema":{"type":"string","maxLength":600}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/events/{slug}":{"get":{"operationId":"get_event","summary":"Get an event","description":"One free public event by slug. The meeting link is only included for a caller with an account key, as on the site.","parameters":[{"name":"slug","in":"path","required":true,"description":"The slug of the item, as returned by the list","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]*$"}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/challenges":{"get":{"operationId":"list_challenges","summary":"List challenges","description":"Contentu challenges: the guided ones of the Contentu Lab+ membership (kind: guided; only their cover is public) and the community ones (kind: community), active or finished.","parameters":[{"name":"limit","in":"query","required":false,"description":"Items per page (max 50)","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page","schema":{"type":"string","maxLength":600}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/challenges/{slug}":{"get":{"operationId":"get_challenge","summary":"Get a challenge","description":"The cover of one challenge by slug: what it is, who it is for and the title of each day or task. Never the content of the days.","parameters":[{"name":"slug","in":"path","required":true,"description":"The slug of the item, as returned by the list","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]*$"}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/courses":{"get":{"operationId":"list_courses","summary":"List courses","description":"The catalogue of Contentu courses: title, summary, number of sessions and the plan that opens each one (requires_plan). The lessons are not included.","parameters":[{"name":"limit","in":"query","required":false,"description":"Items per page (max 50)","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page","schema":{"type":"string","maxLength":600}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/courses/{slug}":{"get":{"operationId":"get_course","summary":"Get a course","description":"The cover of one course: who it is for, what it needs, what you have at the end, its weeks and the title and goal of each session. Never the lessons.","parameters":[{"name":"slug","in":"path","required":true,"description":"The slug of the item, as returned by the list","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]*$"}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/limits":{"get":{"operationId":"get_limits","summary":"Get usage limits","description":"Who the gate thinks you are (anonymous or a key, with its permissions) and the request limits that apply.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{},{"accountKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/me":{"get":{"operationId":"get_me","summary":"Get my profile and plan","description":"The profile of the account that owns the key (name, username, language, country) and its plan: free or lab_plus (Contentu Lab+).","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["profile:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/me/points":{"get":{"operationId":"get_my_points","summary":"Get my points and level","description":"The points and the level of the account that owns the key, and how many points are missing for the next level. Points have no monetary value.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["points:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/me/learning":{"get":{"operationId":"get_my_learning","summary":"Get my courses, challenges and progress","description":"What the account that owns the key has started: guided courses and challenges with sessions done out of the total, and the community challenges it joined. Read only: it never changes progress.","parameters":[{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["learning:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/courses/{slug}/sessions/{n}":{"get":{"operationId":"get_course_session","summary":"Read a course session","description":"The lesson of one session of a Contentu Lab+ course, in markdown (Spanish). Only for a key with content:read whose account is a member, and only for sessions the account has already opened: session 1, or the one after the last completed. It never marks a session as done.","parameters":[{"name":"slug","in":"path","required":true,"description":"The slug of the item, as returned by the list","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]*$"}},{"name":"n","in":"path","required":true,"description":"The number of the session","schema":{"type":"integer","minimum":1,"maximum":400}},{"name":"max_chars","in":"query","required":false,"description":"Cut the long text at this many characters","schema":{"type":"integer","minimum":200,"maximum":120000}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["content:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/me/saved-jobs":{"get":{"operationId":"list_saved_jobs","summary":"List my saved jobs","description":"The openings of the job board the account saved, newest first, each with its own note (saved, applied, in_process, discarded) and the link to apply. A saved opening keeps its copy even after it closes.","parameters":[{"name":"limit","in":"query","required":false,"description":"Items per page (max 50)","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page","schema":{"type":"string","maxLength":600}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["jobs:save"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}},"post":{"operationId":"save_job","summary":"Save a job","description":"Saves an opening of the job board (the id from list_jobs) in the account, for a Contentu Lab+ member. Saving twice keeps one row. It never applies to the job: applying is free and happens on the site of the employer or the source.","parameters":[{"name":"job_id","in":"query","required":true,"description":"The id of the opening, from list_jobs or get_job","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["jobs:save"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/me/saved-jobs/{job_id}":{"delete":{"operationId":"unsave_job","summary":"Remove a saved job","description":"Removes an opening from the saved list of the account, by the id of the opening. Only the owner of the list; the membership is not needed to remove.","parameters":[{"name":"job_id","in":"path","required":true,"description":"The id of the opening","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["jobs:save"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/me/saved-jobs/{id}/status":{"post":{"operationId":"set_saved_job_status","summary":"Set the note of a saved job","description":"Sets the note of a saved opening (the id from list_saved_jobs): saved, applied, in_process or discarded. A note of the person; nothing else reads it.","parameters":[{"name":"id","in":"path","required":true,"description":"The id of the saved row, from list_saved_jobs","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"status","in":"query","required":true,"schema":{"type":"string","enum":["saved","applied","in_process","discarded"]}},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default es)","schema":{"type":"string","enum":["es","en"]}}],"security":[{"accountKey":["jobs:save"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/Problem"},"401":{"$ref":"#/components/responses/Problem"},"403":{"$ref":"#/components/responses/Problem"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}}},"components":{"securitySchemes":{"accountKey":{"type":"http","scheme":"bearer","description":"A key created at https://www.contentu.co/es/cuenta/api (ctu_live_…). Scopes: profile:read (Read the profile and the plan of the account); learning:read (Read the courses, challenges and progress of the account); points:read (Read the points and the level of the account); content:read (Read member content, when the account has a Contentu Lab+ membership); jobs:save (Save openings of the job board and keep a note on each, when the account has a Contentu Lab+ membership)."}},"responses":{"Problem":{"description":"An error (RFC 9457)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"schemas":{"Problem":{"type":"object","required":["type","title","status","code","request_id"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","key_revoked","key_expired","key_blocked","insufficient_scope","membership_required","admin_required","origin_not_allowed","not_found","method_not_allowed","invalid_state","conflict","payload_too_large","unsupported_media_type","rate_limited","internal_error","not_available","not_configured","temporarily_unavailable"],"description":"Stable. Treat an unknown code by its HTTP status."},"request_id":{"type":"string"},"detail":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"reason":{"type":"string"}}}},"required_scope":{"type":"string"},"retry_after_s":{"type":"integer"}}}}}}