# FieldAgentRegisterResponse

Model ID: `fieldagent.RegisterResponse`

Response for POST /auth/register (201). ``access_token``/``id_token``/
``expires_in`` are present only when the deployment sets
``AUTO_VERIFY_EMAIL=true`` *and* the immediate post-registration login
succeeds; otherwise they are omitted and the agent must call
``fieldagent.login`` after verifying their email OTP.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `access_token` | `string` | No |  |  |  | No | Present only when AUTO_VERIFY_EMAIL=true and the immediate post-registration login succeeded. |
| `cognito_sub` | `string` | Yes |  |  |  | No | Cognito subject (user id) for the newly created agent account. |
| `email_otp_sent` | `boolean` | Yes |  |  |  | No | True if an email verification OTP was generated and handed to SendGrid for delivery. False when AUTO_VERIFY_EMAIL is set (no OTP is sent) or delivery could not be attempted. |
| `email_verified` | `boolean` | Yes |  |  |  | No | True only when the deployment auto-verifies email (AUTO_VERIFY_EMAIL=true); otherwise false until the agent completes fieldagent.verifyEmail. |
| `expires_in` | `integer` | No |  |  |  | No | Present only under the same AUTO_VERIFY_EMAIL condition as access_token. |
| `fhir_person_id` | `string|null` | No |  |  |  | Yes | FHIR Person ID created for the agent; use as {agent_id} on other routes. |
| `id_token` | `string|null` | No |  |  |  | Yes | Present only under the same AUTO_VERIFY_EMAIL condition as access_token. |
| `person_type` | `string` | Yes |  |  |  | No | Always 'field_agent' for this endpoint. |

## Example

None declared in canonical OpenAPI.