AwrAIter REST v1
68
AI ReadinessAI-Aware (B+)68/100
Official vendor OpenAPI document · agent-readySocial MediaSocial Publishingbearer56 EndpointsREST
For Agents
Draft, schedule, and analyse social channel posts: create drafts from text, build polls and content plans, find free slots and schedule posts, score drafts, check for duplicates, and read channel insights and stats.
Use for: Draft a post from this text for my main channel, Find the next free slot and schedule the draft there, Create a weekly content plan for a channel, Check whether this post text duplicates anything already published
Not supported: Does not handle ad campaigns, direct messaging, or payment processing. Use for drafting, scheduling, and analysing channel posts only.
The AwrAIter API drafts, schedules, and analyses social channel content from one endpoint per tool. It turns text into post drafts, builds polls and content plans, finds a free slot in a channel's calendar, and schedules or cancels posts. Read tools return channel insights, statistics, recent posts, and search over a channel's posts and sources, while quality tools score a draft and check it for duplicate content before it goes out. Governance tools set a brand brief, channel header and footer, and an autopilot approval policy so a channel stays on-voice.
Install Jentic One Beta
Connect the AwrAIter REST v1 to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the AwrAIter REST v1, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fawraiter.ai%2Fawraiter" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fawraiter.ai%2Fawraiter" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with AwrAIter REST v1 API.
Create a post draft from text, or build a poll draft for a channel
Find a free slot in a channel's calendar and schedule or cancel a post
Build and read a content plan for a channel
Score a draft and check it for duplicate content before publishing
Read channel insights, statistics, and recent posts
Search a channel's posts and sources, and draft from those sources
Set a brand brief, channel header and footer, and an autopilot approval policy
Use Cases
Patterns agents use AwrAIter REST v1 API for, with concrete tasks.
★ Agent Draft-and-Schedule
An AI agent connected through Jentic turns a brief into a scheduled post: it drafts from text, scores the draft and checks it for duplicate content, finds the next free slot in the channel calendar, and schedules it. Each tool is a single endpoint, so the agent chains them without juggling a batch format.
Draft a post from a text brief, score it, check it for duplicates, find the next free slot for the channel, and schedule it
Channel Performance Review
A social manager pulls a channel's insights, statistics, and recent posts to review how content is performing. The AwrAIter API returns the stats over a period and the recent-post history in structured form, so an agent can summarise reach and cadence without scraping the channel.
Fetch a channel's statistics for the last 30 days and its ten most recent posts, then summarise posting cadence and engagement
On-Brand Content Governance
A team keeps a channel on-voice by setting a brand brief, header, and footer, then applying an autopilot approval policy that decides which drafts can post automatically. The AwrAIter API also checks each new draft for uniqueness against prior posts, so repeated content is caught before it ships.
Set a channel's brand brief, apply an autopilot approval policy, and check a candidate draft for duplicate content
Key Endpoints
56 endpoints — the awraiter api drafts, schedules, and analyses social channel content from one endpoint per tool.
METHOD
PATH
DESCRIPTION
POST
/api/v1/create_post_from_text
Create a draft from text
POST
/api/v1/schedule_post
Schedule or publish a post
POST
/api/v1/cancel_scheduled_post
Cancel a scheduled post
GET
/api/v1/find_free_slot
Find a free slot in a channel's calendar
POST
/api/v1/create_content_plan
Create a content plan
GET
/api/v1/get_channel_stats
Read channel statistics
GET
/api/v1/get_channel_insights
Read channel insights
GET
/api/v1/list_channels
List team channels
POST
/api/v1/create_post_from_text
Create a draft from text
POST
/api/v1/schedule_post
Schedule or publish a post
POST
/api/v1/cancel_scheduled_post
Cancel a scheduled post
GET
/api/v1/find_free_slot
Find a free slot in a channel's calendar
POST
/api/v1/create_content_plan
Create a content plan
GET
/api/v1/get_channel_stats
Read channel statistics
GET
/api/v1/get_channel_insights
Read channel insights
GET
/api/v1/list_channels
List team channels
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
A
AwrAIter REST v1
- AI-Aware (B+)68/100
74
Foundational Compliance69
Developer Experience & Jentic Compatibility54
AI-Readiness & Agent Experience93
Agent Usability60
Security74
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.2
Show dimension breakdown
74
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A-Signals: 4
96%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
0%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
69
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B+Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
75%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
54
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: CSignals: 4
58%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
60%
Summary Coverage
Coverage of summaries across operations/tags/info.
93
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
93%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
60
Security
Trust, risk posture, and security compliance.
Grade: B-Signals: 1
60%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
74
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: A-Signals: 1
74%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the AwrAIter API by hand means managing a bearer token, learning its one-endpoint-per-tool layout, and sending an Idempotency-Key on every write tool so retries are safe. Through Jentic you install once, import the AwrAIter API from the API Directory, store the token once, and your agent calls it.
Permission scoping
AwrAIter exposes one endpoint per tool and carries the channel id in the query or body, so a rule bounds which tools your agent may call, not which channel. You choose the operations it may call, so the write tools like schedule-post, cancel-scheduled-post, and set-autopilot-policy are not included unless you add them.
Credential isolation
Your AwrAIter token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'schedule a post' or 'read channel statistics', and Jentic returns the matching AwrAIter tool with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using AwrAIter REST v1 API through Jentic.
What authentication does the AwrAIter API use?
The AwrAIter API authenticates with a bearer token, a personal access token or OAuth token sent as Authorization: Bearer, per its OpenAPI spec. The same token works across the read and write tools. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time, so it never enters the agent's prompt, logs, or context.
Can I draft and schedule a post with the AwrAIter API?
Yes. You create a draft from text, optionally score it and check it for duplicate content, find the next free slot in the channel's calendar, and schedule it. A scheduled post can also be cancelled, so an agent can manage the full draft-to-publish path.
What are the rate limits for the AwrAIter API?
The OpenAPI spec does not state fixed numeric rate limits for the AwrAIter API; write tools accept an Idempotency-Key header so retries are safe. Check https://awraiter.ai for the current limits that apply to your plan.
Is there an AwrAIter MCP server?
Yes, AwrAIter exposes an MCP server alongside this REST surface. You can also connect the AwrAIter API directly through Jentic: your agent gets the full 56-endpoint surface without loading another server's tool definitions into its context, your token is injected at call time by your self-hosted instance instead of living in an MCP config, and your rules decide which tools the agent may call.
Can I limit what my agent is allowed to do with the AwrAIter API?
Yes. Because AwrAIter maps one endpoint to each tool, you write a rule that allows only the read tools, such as channel stats, recent posts, and content search, and leave out the write tools like schedule-post, cancel-scheduled-post, and set-autopilot-policy. The agent can then analyse a channel but never publish, and every call it makes is logged.
How do I schedule a post through Jentic?
Import the AwrAIter API from the Jentic API Directory, store your access token once, and have your agent search Jentic for 'schedule a post'. Jentic returns the schedule-post operation with its input schema so the agent sends the channel and draft and reads back the scheduled time. To run it on your own infrastructure, install Jentic One from its GitHub repo.
GET STARTED