Clever

Connector for the clever API, generated deterministically from its OpenAPI spec (endpoints, auth, and methods match the spec exactly — nothing is invented).

• Base URL: https://api.clever.com/v1.2
• Auth: OAuth 2.0 (user-delegated) — attach an InTouch oauth credential. Mint one with itcli.py /oauth <provider> (device-code) or /google-auth (Google); the server auto-refreshes the access token before each run, so the connector never handles or stores tokens.

Operations

• getcontacts — GET /contacts — Returns a list of student contacts
• getcontact — GET /contacts/{id} — Returns a specific student contact
• getdistrictforstudentcontact — GET /contacts/{id}/district — Returns the district for a student contact
• getstudentforcontact — GET /contacts/{id}/student — Returns the student for a student contact
• getdistrictadmins — GET /district_admins — Returns a list of district admins
• getdistrictadmin — GET /district_admins/{id} — Returns a specific district admin

Inputs

• a linked oauth credential (no key inputs) — the server injects a fresh Authorization: Bearer from it
• operation — one of the operations above
• path parameters when an operation's path contains {...}
• query — optional JSON object of query params
• body — JSON object for create/update ops

Example

operation: getcontacts
# (attach an 'oauth' credential to the task — no inline secrets)