> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relayos.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# GET & PUT /v1/projects/me — Project Settings

> Retrieve your RelayOS project configuration or update your Meta Phone Number ID, access token, and webhook callback URL before sending messages.

The `/v1/projects/me` endpoint gives you access to your project's configuration. Use the `GET` operation to inspect current settings, and the `PUT` operation to connect your Meta credentials and webhook URL before sending your first message.

***

## Retrieve project details

**`GET https://api.relayos.com.br/v1/projects/me`**

Returns the current configuration for your project, including your Meta credentials status and registered callback URL.

```bash theme={null}
curl https://api.relayos.com.br/v1/projects/me \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

<ResponseField name="projectId" type="string">
  Unique identifier for your project.
</ResponseField>

<ResponseField name="name" type="string">
  Project display name.
</ResponseField>

<ResponseField name="ownerEmail" type="string">
  Contact email for the project owner.
</ResponseField>

<ResponseField name="metaPhoneNumberId" type="string">
  Your Meta Phone Number ID, if configured.
</ResponseField>

<ResponseField name="callbackUrl" type="string">
  Webhook URL where RelayOS sends message status events, if configured.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of project creation.
</ResponseField>

```json theme={null}
{
  "projectId": "proj_01hwxyz111aaa",
  "name": "My Production App",
  "ownerEmail": "you@yourcompany.com",
  "metaPhoneNumberId": "1234567890",
  "callbackUrl": "https://yoursite.com/webhook/relayos",
  "createdAt": "2026-05-14T10:00:00Z"
}
```

***

## Update Meta credentials

**`PUT https://api.relayos.com.br/v1/projects/me/meta-credentials`**

Configure or update the Meta credentials and webhook URL that RelayOS uses to send WhatsApp messages on your behalf. You must call this endpoint before you can send any messages.

<ParamField body="metaPhoneNumberId" type="string" required>
  Your WhatsApp Phone Number ID from the Meta Developer Console. Found under **WhatsApp > API Setup** in your Meta app.
</ParamField>

<ParamField body="metaAccessToken" type="string" required>
  A valid Meta access token with `whatsapp_business_messaging` permissions. For production, use a permanent system user token.
</ParamField>

<ParamField body="callbackUrl" type="string">
  HTTPS URL where RelayOS will send webhook events for message status updates (e.g., `DELIVERED`, `READ`, `FAILED`). Optional — you can add or update it at any time.
</ParamField>

```bash theme={null}
curl -X PUT https://api.relayos.com.br/v1/projects/me/meta-credentials \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "metaPhoneNumberId": "1234567890",
    "metaAccessToken": "EAAxxxYYYzzz...",
    "callbackUrl": "https://yoursite.com/webhook/relayos"
  }'
```

### Response

A `200` response confirms the credentials were saved.

<ResponseField name="projectId" type="string">
  Your project identifier.
</ResponseField>

<ResponseField name="metaPhoneNumberId" type="string">
  The Phone Number ID that was saved.
</ResponseField>

<ResponseField name="callbackUrl" type="string">
  The webhook URL that was saved.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp of the update.
</ResponseField>

```json theme={null}
{
  "projectId": "proj_01hwxyz111aaa",
  "metaPhoneNumberId": "1234567890",
  "callbackUrl": "https://yoursite.com/webhook/relayos",
  "updatedAt": "2026-05-14T12:30:00Z"
}
```

<Info>
  The `metaAccessToken` is never returned in responses. To rotate your token, call this endpoint again with the new value.
</Info>