clous-ai/api-integration
clous-development/skills/api-integration/SKILL.md
Use when building or reviewing direct Clous API v1 integrations, including responses, object CRUD, API keys, webhooks, tool endpoints, retries, pagination, and structured error handling.
tools
Updated May 11, 2026
$ install --global
skillsauthnpx skillsauth add clous-ai/agents api-integrationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 11, 2026, 2:28 AM155.9s1 file scanned
SKILL.md
- name:
- api-integration
- description:
- Use when building or reviewing direct Clous API v1 integrations, including responses, object CRUD, API keys, webhooks, tool endpoints, retries, pagination, and structured error handling.
Clous API Integration
Use the Clous API as the source of truth for production integrations. The primary base URL is https://api.clous.app/v1.
Workflow
- Discover capabilities with
GET /v1/info/. - Choose auth: API key for server-to-server, OAuth token for delegated user context.
- Model requests against stable resources:
responses,objects,api-keys,webhooks, andtools. - Implement structured error handling for 401, 403, 404, 429, and 5xx responses.
- Validate with the Python and TypeScript SDKs before handoff.
Endpoints
GET /v1/info/: API discovery.POST /v1/responses/,GET /v1/responses/{id}/: agent runs.GET /v1/objects/types/: supported object resources.GET|POST /v1/objects/{type}/: object collection operations.GET|PATCH|DELETE /v1/objects/{type}/{id}/: object detail operations.GET|POST /v1/webhooks/,GET /v1/webhooks/events/: webhook management.POST /v1/tools/hr-knowledge-retrieve/,POST /v1/tools/clous-support-docs-retrieve/,POST /v1/tools/systemlog-errors-retrieve/: worker tool endpoints.
Guardrails
- Do not log bearer tokens, OAuth codes, refresh tokens, webhook secrets, or employee payloads.
- Prefer idempotent retries only for GET and explicitly safe POST calls.
- For mutations, include a human-readable intent, actor, and correlation ID when the host supports headers.
Related Skills
clous-ai/webhook-operations
development
VerifiedTrustedCommunity
Use when an AI agent needs to inspect, create, update, delete, or troubleshoot Clous webhook subscriptions and events.
SKILL.mdUpdated May 11, 2026
clous-ai/platform-operation
tools
VerifiedTrustedCommunity
Use when an external AI agent needs to operate Clous safely across MCP, SDK, CLI, and API surfaces while preserving user/company context and avoiding unsafe mutations.
SKILL.mdUpdated May 11, 2026
clous-ai/object-management
tools
VerifiedTrustedCommunity
Use when reading, creating, updating, or deleting Clous objects such as employees, candidates, jobs, reviews, skills, and forms.
SKILL.mdUpdated May 11, 2026
clous-ai/mcp-use
tools
VerifiedTrustedCommunity
Use when an AI agent can call Clous remote MCP tools to inspect or operate the Clous platform, HR, or employee surfaces.
SKILL.mdUpdated May 11, 2026