Files
Anthropic-Cybersecurity-Skills/skills/implementing-soar-automation-with-phantom/references/api-reference.md
T
mukul975 27c6414ca5 Add folder anatomy (scripts/agent.py + references/api-reference.md) for 648 cybersecurity skills
Complete skill folder anatomy across all cybersecurity skills:
- scripts/agent.py: 80-150 line Python agents using real libraries (impacket,
  boto3, azure-mgmt-*, kubernetes, pefile, yara, scapy, shodan, stix2, etc.)
- references/api-reference.md: real API documentation with method signatures
- LICENSE: MIT license for all skill folders
2026-03-10 21:02:12 +01:00

2.6 KiB

API Reference: Implementing SOAR Automation with Phantom

Libraries

requests (HTTP Client for SOAR REST API)

  • Install: pip install requests
  • Authentication: ph-auth-token header with API token

Splunk SOAR REST API

Playbooks

Endpoint Method Description
/rest/playbook GET List all playbooks
/rest/playbook/{id} GET Get playbook details
/rest/playbook_run POST Execute a playbook

Containers (Events/Incidents)

Endpoint Method Description
/rest/container GET List containers
/rest/container POST Create new container
/rest/container/{id} GET Get container details
/rest/container/{id} POST Update container

Artifacts (IOCs)

Endpoint Method Description
/rest/artifact POST Add artifact to container
/rest/artifact/{id} GET Get artifact details
CEF fields: sourceAddress, destinationAddress, fileHash, fileName

Actions

Endpoint Method Description
/rest/action_run POST Run an action on an asset
/rest/action_run/{id} GET Get action results
/rest/app GET List installed apps
/rest/asset GET List configured assets

System

Endpoint Method Description
/rest/system_info GET System version and status
/rest/ph_user GET List SOAR users

Common App Actions

App Action Description
VirusTotal file_reputation Check hash reputation
VirusTotal url_reputation Check URL safety
CrowdStrike contain_device Network isolate host
ActiveDirectory disable_user Disable AD account
ServiceNow create_ticket Create incident ticket
Exchange quarantine_email Remove phishing email
Splunk run_query Execute SPL search

Playbook Types

  • Automation: Fully automated, no analyst input
  • Investigation: Enrichment with analyst decision gates
  • Response: Containment actions with approval prompts
  • Reporting: Data collection and notification

External References