What authentication does the Agility Writer API use?

The API uses an apiKey header named Authorization carrying your Agility Writer key. Jentic stores the key in its vault and injects it on each request, so the raw token never enters the agent's context window.

How long does it take to generate an article through the Agility Writer API?

Generation is asynchronous. POST / returns an articleId immediately and the article body becomes available on GET /{articleId} once the job completes. Typical long-form jobs take minutes rather than seconds, so poll on a backoff rather than a tight loop.

Can I generate multiple articles in parallel?

Yes - each POST / starts an independent job and returns its own articleId. There is no batch endpoint, so issue concurrent create calls and track each articleId separately when polling for status.

How do I generate an article through Jentic?

Search Jentic for 'generate an SEO article'. Load the POST / schema, execute with your topic and target keyword, capture the returned articleId, then load and execute GET /{articleId} to retrieve the finished article body. Jentic handles the Authorization header end-to-end.

What are the rate limits for the Agility Writer API?

The OpenAPI spec does not declare explicit rate limits. Because generation is long-running, throughput is naturally bounded by job concurrency rather than request rate. Use exponential backoff on the GET /{articleId} polling call.

Can I limit what my agent is allowed to do with the Agility Writer API?

Yes. Because you run Jentic One yourself, your own rules decide which of the Agility Writer operations your agent can call and which credentials it may use. The API exposes just two operations, creating an article (POST /, with the topic and configuration in the request body) and reading an article by id (GET /{articleId}, with the id in the URL path), so you can allow only creation, restrict the agent to reading a specific article id, or permit both. Any operation you leave out of the allowed set is not reachable by the agent.