Back to Documentation

Quickstart

Get up and running with BringSkills API in under 5 minutes.

Prerequisites

  • A BringSkills account (sign up for free)
  • An API token (we'll create one below)
  • curl or any HTTP client
1

Create an API Token

API tokens authenticate your requests to BringSkills. Each token is tied to your account and can be configured for specific AI agents.

  1. Go to your Dashboard
  2. Click on API Tokens in the sidebar
  3. Click Create Token
  4. Give your token a name (e.g., "My First Token")
  5. Select your AI agent (optional - for optimized formatting)
  6. Copy and save your token securely

⚠️ Important: Your token is only shown once. Store it securely - you won't be able to see it again.

2

Browse Available Skills

Explore our marketplace to find skills that match your needs. You can browse by category, search by keyword, or use the API.

List all skills
bash
curl https://api.bringskills.com/api/v1/skills \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Or browse the Skill Marketplace to discover skills with ratings, reviews, and detailed descriptions.

3

Get a Skill (Free or Paid)

Before executing a skill, you need to add it to your account. Free skills can be added instantly, while paid skills require a one-time purchase.

Get a free skill
bash
curl -X POST https://api.bringskills.com/api/v1/orders/free \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"skill_slug": "text-analyzer"}'
4

Execute Your First Skill

Now for the fun part! Execute a skill by sending a POST request with your input data.

Execute a skill
bash
curl -X POST https://api.bringskills.com/api/v1/skills/text-analyzer/execute \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "text": "BringSkills makes AI integration easy!"
    }
  }'

Response

{
  "success": true,
  "result": {
    "word_count": 5,
    "character_count": 38,
    "sentiment": "positive",
    "confidence": 0.92
  },
  "execution_time_ms": 45,
  "agent_detected": "curl/generic"
}

What's Next?

Authentication Deep Dive

Learn about token scopes, refresh tokens, and security best practices.

Agent Integration

Configure BringSkills for your specific AI agent.

Skills API Reference

Complete API documentation for skill management.

Error Handling

Handle errors gracefully in your applications.

Documentation HomeAuthentication