Background Processes
List background processes
List all background processes on the server.
Processing mode: <small><code>sync</code></small>
get/orgs/{organization}/servers/{server}/background-processes
Request
- Base URLhttps://forge.laravel.com/api
- AuthOAuth 2Authorization codehttps://forge.laravel.com/oauth/authorizeToken URLhttps://forge.laravel.com/oauth/tokenScopesserver:view
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
organizationstring required
The organization slug
serverinteger required
The server ID
Query parameters
sortstring
Available sorts are user. You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -user.
page[size]integer
The number of results that will be returned per page.
page[cursor]string
The cursor to start the pagination from.
filter[user]string
Example:forge
The user that the process is running as.
filter[site_id]string
The site ID that the process is running for.
filter[directory]string
Example:/home/forge/forge.laravel.com
The directory that the process is running in.
Response
Paginated set of BackgroundProcessResource
Example response
{
"data": [
{
"attributes": {
"command": "php artisan queue:work database",
"user": "forge",
"directory": "/home/forge/forge.laravel.com",
"processes": 3,
"status": "running",
"created_at": "2025-07-29T09:00:00Z"
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.