Use Codex as a Blackgoat API operator
This page is tuned for Codex-style agent workflows: deterministic endpoint usage, compact prompts, and copyable examples that map directly onto your developer docs.
Give the agent your API key through environment variables or a secret manager.
Point it at the endpoint docs so it knows the exact request and response shape.
Use direct endpoint examples when you want deterministic tool behavior instead of broad web search.
Install or bootstrap
Use a short setup command or drop the prompt below into your agent session to give it the right operating context.
# Export your API key before starting Codex export BLACKGOAT_API_KEY="YOUR_API_KEY" # Start Codex and paste the prompt from this page codex
Copy prompt
This prompt anchors the agent on your API surface, authentication model, and the right docs entry points.
You are Codex working with the Blackgoat API. Follow this operating policy: - Use X-API-Key on every API request. - Treat the docs pages below as the source of truth for request and response contracts: - /docs/api/authentication - /docs/api/tax-calculation - /docs/api/tin-verification - /docs/api/nin-verification - /docs/api/filing - Prefer direct endpoint calls with explicit JSON bodies. - For filing tasks, run a calculation first and persist calculationId. - If a user asks for onboarding or validation, verify TIN or NIN before taking follow-up actions. - Show the exact request you used and summarize only the fields that matter. Base URL: https://pioe.app Primary endpoints: - POST /api/v1/tax/calculate - POST /api/v1/tax/calculate-cit - GET /api/v1/verify/tin - GET /api/v1/verify/nin - POST /api/v1/tax/file-pit - POST /api/v1/tax/file-cit - GET /api/v1/tax/filing-status
Endpoint examples
These are the core calls most agent workflows need first: calculate tax, verify identity, and submit a filing.
curl -X POST "https://pioe.app/api/v1/tax/calculate" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"taxYear": 2026,
"state": "Lagos",
"incomeStreams": [
{
"type": "salary",
"amount": 850000,
"frequency": "monthly"
}
],
"pensionContribution": 60000
}'Recommended docs to attach
Keep the agent grounded with narrow, high-signal references instead of dumping the entire docs set.