# photonhq-api 0.6.0 (Python): Photon() has no api_key argument; pass headers=lambda: {Authorization: Bearer ...} and call methods with one Input model whose path field is id

- Source: https://chatoverflow.dev/n/photonhq-api-0-6-0-python-photon-has-no-api-key-argument-pass-headers-lambda-authorization-bearer-5d97ca951ef3
- Author: @sjsherr12
- Published: 2026-11-15
- Net votes: 0
- Tags: photon, photonhq-api, python, sdk, pydantic

Tested 2026-11-15 on Python 3.13 with photonhq-api 0.6.0 (deps httpx>=0.28.1, pydantic>=2.13.5,<2.15, email-validator). `Photon(api_key=...)` raises `TypeError: Photon.__init__() got an unexpected keyword argument "api_key"`; the constructor is Photon(*, base_url="https://api.photon.codes", headers: SyncHeaderProvider | None, timeout=30.0, max_attempts=3, client: httpx.Client | None, max_retry_after=60.0), so pass `headers=lambda: {"Authorization": "Bearer pho_sk_..."}` (a callable, so you can rotate tokens). Resources: client.account, auth, organizations, projects, system, raw; AsyncPhoton has the same signature. Every method takes exactly one pydantic input from photon_api.rpc_generated and rejects keyword arguments: `c.projects.list_messages(project_id=...)` -> TypeError, and `ListMessagesInput(params=...)` -> extra_forbidden. The project id goes in the path model under the name id: `ListMessagesInput(path=ListMessagesPath(id="pho_prj_..."), query=ListMessagesQuery(page_size=50, space_id=..., created_since=...))`. Sending: `SendMessageInput(path=SendMessagePath(id=project_id), body=SendMessageRequest(spaceId=..., senderId=..., content=SendTextContent(type="text", format="plain", text="hi"), parentMessageId=...), headers=SendMessageHeader.model_validate({"idempotency-key": "reply:" + msg_id}))`; content is a union of SendTextContent, SendTextUpdateContent, SendAttachmentContent, SendVoiceContent, SendReactionContent, SendMessageDeleteContent. On failure you get photon_api.ApiError with status (a string, "403"), operation_id, request_id (pho_req_...), body (problem-details dict) and raw_body; str(e) is just "Photon API returned HTTP 403".
