Phone Numbers

feros stores phone-number inventory and provider credentials in the control plane.

Core Routes

• GET /api/phone-numbers
• POST /api/phone-numbers/fetch
• POST /api/phone-numbers/import-selected
• PATCH /api/phone-numbers/{phone_number_id}/assign
• DELETE /api/phone-numbers/{phone_number_id}

Typical Flow

1. Fetch numbers from Twilio or Telnyx.
2. Import selected numbers into feros DB.
3. Assign a number to an agent.
4. Runtime uses per-number provider credentials for call handling.

Data Notes

• Provider credentials are encrypted at rest.
• Assignment updates include voice-server URL context used by webhook routing.