Ouropal Opal API
✓ Official Vendor SpecContent ManagementContent Planningoauth210 EndpointsREST
For Agents
Manage content planning with Opal: access boards, moments, content schedules, collaborators, and custom fields for content calendar and creative workflow management.
Use for: List all content boards for a project, Get moments scheduled for this week, Retrieve board collaborators and permissions, Access custom fields for a board
Not supported: Does not publish content, manage media assets, or handle social media posting — use only for content planning, calendar management, and team collaboration workflows.
Opal is a content planning and collaboration platform for creative teams, social media managers, and marketing agencies. The v3 API (work in progress) follows the JSON:API specification and provides programmatic access to boards, moments (content items), content schedules, collaborators, and custom fields. Opal helps teams plan, organize, and collaborate on content calendars with visual boards, deadlines, and team workflows. Note: The v2 API is more complete in some areas; this is the v3 iteration.
Install Jentic One Beta
Connect the Opal API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Opal API, 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://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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 Opal API.
Retrieve and manage boards for organizing content by project, campaign, or theme
Access moments (content items) with metadata, schedules, and assignments
List and manage content schedules for planning publication dates
Manage board collaborators and team permissions
Access and configure custom fields for extending board and moment metadata
List board objects including content pieces, assets, and planning items
Organize content calendars with visual planning and deadlines
Collaborate on content workflows with team members
Use Cases
Patterns agents use Opal API for, with concrete tasks.
★ Social Media Content Calendar Integration
Social media managers can integrate Opal boards with publishing tools to automate content workflows. GET /api/v3/boards retrieves content boards, GET /api/v3/moments lists scheduled content items, and collaborator endpoints manage team assignments. Agents can pull scheduled posts from Opal, sync with publishing platforms like Buffer or Hootsuite, and update status in both systems.
GET /api/v3/boards to list content boards, then GET /api/v3/moments filtered by date range to retrieve scheduled social media posts for publication automation.
Marketing Campaign Planning Dashboards
Marketing teams can build custom dashboards that aggregate content planning data from Opal. GET /api/v3/boards/{board_id}/objects retrieves all content items in a campaign board, and GET /api/v3/boards/{board_id}/collaborators shows team assignments. This enables executive views of campaign status, content pipeline, and team workload without manual reporting.
GET /api/v3/boards to list campaign boards, then GET /api/v3/boards/{board_id}/objects for each board to aggregate content status and build dashboard views.
Agency Client Content Reporting
Marketing agencies managing multiple client content calendars can generate automated reports. GET /api/v3/boards with client filters lists client boards, and GET /api/v3/moments retrieves scheduled content by client. Agents can produce weekly or monthly content summaries, track deliverables against contracts, and provide transparency to clients without manual spreadsheet updates.
GET /api/v3/boards filtered by client, then GET /api/v3/moments for each board to generate client-specific content reports with scheduled and completed items.
Content Workflow Automation
Teams can automate content approval workflows by integrating Opal with task management and approval tools. GET /api/v3/moments retrieves content items, custom fields track approval status, and collaborator data shows reviewers. Agents can trigger notifications when content reaches review stages, route to approvers, and update status after approval without manual coordination.
GET /api/v3/moments to find content items in review stage, then use custom fields and collaborators to route approval requests and update status after review.
AI Agent for Content Planning Operations
Let an AI agent handle content planning tasks for a marketing team — retrieving scheduled content, checking team assignments, and generating content reports. Through Jentic, the agent loads only the required operations and Opal OAuth tokens are injected at execution time.
Use the Jentic search query 'list opal content boards' to find GET /api/v3/boards, load its schema, and execute to retrieve content boards for planning analysis.
Key Endpoints
10 endpoints — opal is a content planning and collaboration platform for creative teams, social media managers, and marketing agencies.
METHOD
PATH
DESCRIPTION
GET
/api/v3/boards
List all content boards
GET
/api/v3/boards/{board_id}
Get a specific board with details
GET
/api/v3/boards/{board_id}/objects
List all objects (content items) in a board
GET
/api/v3/boards/{board_id}/collaborators
List board collaborators and permissions
GET
/api/v3/moments
List content moments with schedules
GET
/api/v3/moments/{moment_id}
Get a specific moment's details
GET
/api/v3/boards
List all content boards
GET
/api/v3/boards/{board_id}
Get a specific board with details
GET
/api/v3/boards/{board_id}/objects
List all objects (content items) in a board
GET
/api/v3/boards/{board_id}/collaborators
List board collaborators and permissions
GET
/api/v3/moments
List content moments with schedules
GET
/api/v3/moments/{moment_id}
Get a specific moment's details
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Opal OAuth2 tokens are stored encrypted in the Jentic vault and injected at execution time. User tokens never appear in agent prompts or transcripts.
Intent-based discovery
Agents search by intent such as 'list content boards' or 'get scheduled moments' and Jentic returns the matching endpoint with its schema.
Time to first call
Direct Opal integration: 1-2 days to implement OAuth2 and model boards, moments, and JSON:API structure. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
Notion API
General-purpose workspace and content planning alternative to Opal.
Choose Notion for all-in-one workspace and documentation; choose Opal for specialized content calendar and creative workflow planning.
FAQs
Specific to using Opal API through Jentic.
What authentication does the Opal API use?
The Opal API uses OAuth2 authentication. Users must authorize your application to access their Opal data through the OAuth flow. Access tokens are included in requests. Through Jentic, tokens are managed securely and injected at execution time.
What is the difference between v2 and v3 of the Opal API?
The v3 API follows the JSON:API specification for better standardization and consistency. However, v2 is more complete in some areas as v3 is still a work in progress. Choose v3 for new integrations and JSON:API compatibility.
What are moments in Opal?
Moments are individual content items within a board — social posts, blog articles, videos, or any planned content piece. Each moment has metadata like schedules, assignments, custom fields, and status.
Can I create or update content through the API?
The v3 API currently focuses on retrieval endpoints (GET). Creation and update operations may be available in v2 or will be added to v3 as it matures. Check the API documentation for the latest capabilities.
How do I organize content by client or campaign?
Use boards to organize content by client, campaign, or project. Each board can have its own collaborators, custom fields, and content items (moments). List boards with GET /api/v3/boards to access organizational structure.
What are custom fields used for?
Custom fields extend boards and moments with additional metadata like approval status, content type, priority, tags, or client-specific attributes. They enable flexible content planning workflows beyond standard fields.
GET STARTED